Hexo + Github 搭建个人博客

欢迎来到 scofieldwenwen 的个人博客,受到 stormzhang 的影响,决定开始搭建自己的博客。该文是我自己搭建博客的过程,采用的是 Hexo 博客框架管理,使用 Github 托管,将自己的域名关联到 Github Pages 上。

安装 git

  • 在 Windows 平台下载安装 Git, 点击下载Git
  • 安装教程: 在 Windows 上安装 Git
  • Git 的命令就是 Linux 的 shell 命令行: Git 基本操作命令
  • 查看 Git 安装是否完成,在 win+r 中输入 cmd 命令窗口弹出后,输入 git –version 查看 git 版本
  • 设置 Git 的用户名和邮箱:
    $ git config –global user.name “scofieldwenwen”
    $ git config –global user.email “scofieldwenwen@163.com”

安装 Node.js

  • Node.js 官网下载, 下载后基本都是点击下一步完成安装.
  • 查看 Node.js 是否安装完成,在 win+r 中输入 cmd 命令窗口弹出后,输入 node -v 查看 Node 版本

安装 Hexo

  • 在创建目标文件夹 (如 D:\hexo),在 hexo 文件夹里,单机右键选择 Git Bash Here,输入以下命令安装 Hexo :
    $ npm install -g hexo-cli
  • Hexo 初始化配置
    $ npm hexo init
    $ npm install

  • 初始化之后, hexo 的结构目录如下:

  • Hexo 常用的命令行:
    hexo help #查看帮助
    hexo init #初始化一个目录
    hexo new “postName” #新建文章
    hexo new page “pageName” #新建页面
    hexo generate #生成生成静态网页,可以在 public 目录查看整个网站的文件
    hexo server #本地预览,’Ctrl+C’关闭
    hexo deploy #部署.deploy目录
    hexo clean #清除缓存,强烈建议每次执行命令前先清理缓存,每次部署前先删除 .deploy 文件夹

    简写:
    hexo n == hexo new
    hexo g == hexo generate
    hexo s == hexo server
    hexo d == hexo deploy

  • Hexo 安装 server,生成静态文件后,用 server 启动服务器,从而预览。
    $ npm install hexo-server –save

  • 可以就可以查看第一个 hexo 默认生成的 blog ,输入命令:
    $ hexo generate

    $ hexo server 
    

    在浏览器查看本地静态网页:http://localhost:4000/

    看到这个页面有点小激动,本地博客搭建起来了,不过只是个本地的网页而已,接下来就要把网页部署上去。
    

将博客部署到 Github Pages 上

  • 准备一个 Github 账号,没有的就去官网注册一个账号。
  • 创建一个仓库 repository,用来托管博客。仓库名必须为 [github用户名].github.io

  • 配置 SSH 密钥教程:github 设置添加 SSH

  • 将本地的 Hexo 文件同步到 Github 的仓库中:
    复制刚才创建仓库的 HTTPS 链接

    将链接粘贴到 Hexo 文件目录的 _config.yml 配置文件上保存:
    deploy:
    
    type: git
    repo: https://github.com/scofieldwenwen/scofieldwenwen.github.io.git
    branch: master
    
    注意:配置文件键值之间必须有个空格
    将博客部署上去:
    $ hexo g
    $ hexo d
    或者直接输入
    $ hexo g -d
    在浏览器查看 Github Pages,在浏览器输入 username.github.io (我的是scofieldwenwen.github.io) 就可以看到自己的博客了!到这里一个免费的博客就创建好了。

配置博客以及主题

  • 配置博客: Hexo 官网教程
  • Hexo 官网 选取主题
  • 将主题在 Github 上打开,复制 Clone HTTPS ,然后在在 hexo\theme 目录下 clone 该主题,如我使用是Next主题
    git clone https://github.com/iissnan/hexo-theme-next.git
  • clone 成功后,修改 Hexo 目录中的配置文件 _config.yml 的主题 ,主题名字为 clone 下来的主题文件夹名称
    theme: hexo-theme-next
  • 生成静态网页,查看本地效果
    $ hexo g
    
    $ hexo s
  • 效果可以的话,就部署到 Github 上
    $ hexo clean
    $ hexo g -d

将自己的域名关联上 Github Pages 上

  • 购买一个域名,我的是在 阿里云 上购买的。
  • 配置 CNAME 文件
    在 \hexo\source 文件夹下创建文件 CNAME (没有后缀名),编辑内容,填写申请的域名。
  • 修改 DNS
  • 注意: 不能有不能有相同的主机记录,比如我的邮箱也有 @ 的主机记录,我就不需要邮箱就把它删了。

大功告成

  • 最后网页部署,浏览器输入域名(scofieldwenwen.com)或者自己 Github Pages 的地址

总结

  • 搭建 hexo 中还会用到一些插件,这个因人而异,当然这些插件都是有说明文档的,照着来就行。
  • 万事开头难,但是一旦开始就要把它做好!
  • 接下来就是要坚持写自己的博客了,记录总结,留下自己成长的过程!